home *** CD-ROM | disk | FTP | other *** search
/xlv1/freeware/1998.Oct/procmail/3.11pre7/procmail-3.11pre7.diffbuild/new PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) NNNNAAAAMMMMEEEE procmailrc - procmail rcfile SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS $$$$HHHHOOOOMMMMEEEE////....pppprrrrooooccccmmmmaaaaiiiillllrrrrcccc DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN For a quick start, see NNNNOOOOTTTTEEEESSSS at the end of the pppprrrrooooccccmmmmaaaaiiiillll(1) man page. The rcfile can contain a mixture of environment variable assignments (some of which have special meanings to procmail), and recipes. In their most simple appearance, the recipes are simply one line regular expressions that are searched for in the header of the arriving mail. The first recipe that matches is used to determine where the mail has to go (usually a file). If processing falls off the end of the rcfile, procmail will deliver the mail to $$$$DDDDEEEEFFFFAAAAUUUULLLLTTTT. There are two kinds of recipes: delivering and non- delivering recipes. If a _d_e_l_i_v_e_r_i_n_g _r_e_c_i_p_e is found to match, procmail considers the mail (you guessed it) delivered and will _c_e_a_s_e _p_r_o_c_e_s_s_i_n_g the rcfile after having successfully executed the action line of the recipe. If a _n_o_n-_d_e_l_i_v_e_r_i_n_g _r_e_c_i_p_e is found to match, processing of the rcfile will _c_o_n_t_i_n_u_e after the action line of this recipe has been executed. Delivering recipes are those that cause header and/or body of the mail to be: written into a file, absorbed by a program or forwarded to a mailaddress. Non-delivering recipes are: those that cause the output of a program or filter to be captured back by procmail or those that start a nesting block. You can tell procmail to treat a _d_e_l_i_v_e_r_i_n_g _r_e_c_i_p_e as if it were a non-delivering recipe by specifying the `c' flag on such a recipe. This will make procmail generate a _c_a_r_b_o_n _c_o_p_y of the mail by delivering it to this recipe, yet continue processing the rcfile. By using any number of recipes you can presort your mail extremely straightforward into several mailfolders. Bear in mind though that the mail can arrive concurrently in these mailfolders (if several procmail programs happen to run at the same time, not unlikely if a lot of mail arrives). To make sure this does not result in a mess, proper use of lockfiles is highly recommended. The environment variable aaaassssssssiiiiggggnnnnmmmmeeeennnnttttssss and rrrreeeecccciiiippppeeeessss can be freely intermixed in the rcfile. If any environment variable Page 1 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) has a special meaning to procmail, it will be used appropriately the moment it is parsed (i.e. you can change the current directory whenever you want by specifying a new MMMMAAAAIIIILLLLDDDDIIIIRRRR, switch lockfiles by specifying a new LLLLOOOOCCCCKKKKFFFFIIIILLLLEEEE, change the umask at any time, etc., the possibilities are endless :-). The assignments and substitutions of these environment variables are handled exactly like in sssshhhh(1) (that includes all possible quotes and escapes), with the added bonus that blanks around the '=' sign are ignored and that, if an environment variable appears without a trailing '=', it will be removed from the environment. Any program in backquotes started by procmail will have the entire mail at its stdin. CCCCoooommmmmmmmeeeennnnttttssss A word beginning with # and all the following characters up to a NEWLINE are ignored. This does not apply to condition lines, which cannot be commented. RRRReeeecccciiiippppeeeessss A line starting with ':' marks the beginning of a recipe. It has the following format: :0 [_f_l_a_g_s] [ : [_l_o_c_a_l_l_o_c_k_f_i_l_e] ] <zero or more conditions (one per line)> <exactly one action line> Conditions start with a leading `*', everything after that character is passed on to the internal egrep lllliiiitttteeeerrrraaaallllllllyyyy, except for leading and trailing whitespace. These regular expressions are ccccoooommmmpppplllleeeetttteeeellllyyyy compatible to the normal eeeeggggrrrreeeepppp(1) extended regular expressions. See also EEEExxxxtttteeeennnnddddeeeedddd rrrreeeegggguuuullllaaaarrrr eeeexxxxpppprrrreeeessssssssiiiioooonnnnssss. Conditions are anded; if there are no conditions the result will be true by default. _F_l_a_g_s can be any of the following: HHHH Egrep the header (default). BBBB Egrep the body. DDDD Tell the internal egrep to distinguish between upper and lower case (contrary to the default which is to ignore case). Page 2 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) AAAA This recipe will not be executed unless the conditions on the last preceding recipe (on the current block- nesting level) without the `A' or `a' flag matched as well. This allows you to chain actions that depend on a common condition. aaaa Has the same meaning as the `A' flag, with the additional condition that the immediately preceding recipe must have been _s_u_c_c_e_s_s_f_u_l_l_y completed before this recipe is executed. EEEE This recipe only executes if the immediately preceding recipe was not executed. Execution of this recipe also disables any immediately following recipes with the 'E' flag. This allows you to specify `else if' actions. eeee This recipe only executes if the immediately preceding recipe _f_a_i_l_e_d (i.e. the action line was attempted, but resulted in an error). hhhh Feed the header to the pipe, file or mail destination (default). bbbb Feed the body to the pipe, file or mail destination (default). ffff Consider the pipe as a filter. cccc Generate a ccccaaaarrrrbbbboooonnnn ccccooooppppyyyy of this mail. This only makes sense on _d_e_l_i_v_e_r_i_n_g recipes. The only non-delivering recipe this flag has an effect on is on a nesting block, in order to generate a carbon copy this will cccclllloooonnnneeee the running procmail process (lockfiles will not be inherited), whereby the clone will proceed as usual and the parent will jump across the block. wwww Wait for the filter or program to finish and check its exitcode (normally ignored); if the filter is unsuccessful, then the text will not have been filtered. WWWW Has the same meaning as the `w' flag, but will suppress any `Program failure' message. iiii Ignore any write errors on this recipe (i.e. usually due to an early closed pipe). Page 3 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) rrrr Raw mode, do not try to ensure the mail ends with an empty line, write it out as is. There are some special conditions you can use that are not straight regular expressions. To select them, the condition must start with: !!!! Invert the condition. $$$$ Evaluate the remainder of this condition according to sssshhhh(1) substitution rules inside double quotes, skip leading whitespace, then reparse it. ???? Use the exitcode of the specified program. <<<< Check if the total length of the mail is shorter than the specified (in decimal) number of bytes. >>>> Analogous to '<'. vvvvaaaarrrriiiiaaaabbbblllleeeennnnaaaammmmeeee ?? Match the remainder of this condition against the value of this environment variable (which cannot be a pseudo variable). A special case is if variablename is equal to `B', `H', `HB' or `BH'; this merely overrides the default header/body search area defined by the initial flags on this recipe. \\\\ To quote any of the above at the start of the line. LLLLooooccccaaaallll lllloooocccckkkkffffiiiilllleeee If you put a second (trailing) ':' on the first recipe line, then procmail will use a _l_o_c_a_l_l_o_c_k_f_i_l_e (for this recipe only). You can optionally specify the locallockfile to use; if you don't however, procmail will use the destination filename (or the filename following the first '>>') and will append $LOCKEXT to it. RRRReeeecccciiiippppeeee aaaaccccttttiiiioooonnnn lllliiiinnnneeee The action line can start with the following characters: !!!! Forwards to all the specified mail addresses. |||| Starts the specified program, possibly in $SHELL if any of the characters $SHELLMETAS are spotted. You can optionally prepend this pipe symbol with _v_a_r_i_a_b_l_e=, which will cause stdout of the program to be captured in the environment _v_a_r_i_a_b_l_e (procmail will nnnnooootttt terminate processing the rcfile at this point). If you specify just this pipe symbol, without any program, then procmail will pipe the mail to stdout. Page 4 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) {{{{ Followed by at least one space, tab or newline will mark the start of a nesting block. Everything up till the next closing brace will depend on the conditions specified for this recipe. Unlimited nesting is permitted. The closing brace exists merely to delimit the block, it will _n_o_t cause procmail to terminate in any way. If the end of a block is reached processing will continue as usual after the block. On a nesting block, the flags `H' and `B' only affect the conditions leading up to the block, the flags `h' and `b' have no effect whatsoever. Anything else will be taken as a mailbox name (either a filename or a directory, absolute or relative to the current directory (see MAILDIR)). If it is a (possibly yet nonexistent) filename, the mail will be appended to it. If it is a directory, the mail will be delivered to a newly created, guaranteed to be unique file named $MSGPREFIX* in the specified directory. If the directory name ends in "/.", then this directory is presumed to be an MH folder; i.e. procmail will use the next number it finds available. When procmail is delivering to directories, you can specify multiple directories to deliver to (procmail will do so utilising hardlinks). EEEEnnnnvvvviiiirrrroooonnnnmmmmeeeennnntttt vvvvaaaarrrriiiiaaaabbbblllleeee ddddeeeeffffaaaauuuullllttttssss LLLLOOOOGGGGNNNNAAAAMMMMEEEE,,,, HHHHOOOOMMMMEEEE aaaannnndddd SSSSHHHHEEEELLLLLLLL Your (the recipient's) defaults SSSSHHHHEEEELLLLLLLLMMMMEEEETTTTAAAASSSS &|<>~;?*[ SSSSHHHHEEEELLLLLLLLFFFFLLLLAAAAGGGGSSSS -c OOOORRRRGGGGMMMMAAAAIIIILLLL /var/mail/$LOGNAME (Unless ----mmmm has been specified, in which case it is unset) MMMMAAAAIIIILLLLDDDDIIIIRRRR $HOME/ (Unless the name of the first successfully opened rcfile starts with `./' or if ----mmmm has been specified, in which case it defaults to `.') DDDDEEEEFFFFAAAAUUUULLLLTTTT $ORGMAIL Page 5 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) MMMMSSSSGGGGPPPPRRRREEEEFFFFIIIIXXXX msg. SSSSEEEENNNNDDDDMMMMAAAAIIIILLLL /usr/lib/sendmail SSSSEEEENNNNDDDDMMMMAAAAIIIILLLLFFFFLLLLAAAAGGGGSSSS -oi HHHHOOOOSSSSTTTT The current hostname CCCCOOOOMMMMSSSSAAAATTTT no (If an rcfile is specified on the command line) LLLLOOOOCCCCKKKKEEEEXXXXTTTT .lock Other cleared or preset environment variables are IFS, ENV, PWD and PATH=/usr/freeware/bin:/usr/sbin:/usr/bsd:/sbin :/usr/bin:/usr/bin/X11:. For security reasons, procmail will wipe out all environment variables starting with LD_ upon startup. EEEEnnnnvvvviiiirrrroooonnnnmmmmeeeennnntttt Before you get lost in the multitude of environment variables, keep in mind that all of them have reasonable defaults. MMMMAAAAIIIILLLLDDDDIIIIRRRR Current directory while procmail is executing (that means that all paths are relative to $MAILDIR). DDDDEEEEFFFFAAAAUUUULLLLTTTT Default mmmmaaaaiiiillllbbbbooooxxxx file (if not told otherwise, procmail will dump mail in this mailbox). Procmail will automatically use $DEFAULT$LOCKEXT as lockfile prior to writing to this mailbox. You do not need to set this variable, since it already points to the standard system mailbox. LLLLOOOOGGGGFFFFIIIILLLLEEEE This file will also contain any error or diagnostic messages from procmail (normally none :-) or any other programs started by procmail. If this file is not specified, any diagnostics or error messages will be mailed back to the sender. See also LLLLOOOOGGGGAAAABBBBSSSSTTTTRRRRAAAACCCCTTTT. VVVVEEEERRRRBBBBOOOOSSSSEEEE You can turn on _e_x_t_e_n_d_e_d _d_i_a_g_n_o_s_t_i_c_s by setting this variable to `yes' or `on', to turn it off again set it to `no' or `off'. Page 6 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) LLLLOOOOGGGGAAAABBBBSSSSTTTTRRRRAAAACCCCTTTT Just before procmail exits it logs an abstract of the delivered message in $LOGFILE showing the `From ' and `Subject:' fields of the header, what folder it finally went to and how long (in bytes) the message was. By setting this variable to `no', generation of this abstract is suppressed. If you set it to `all', procmail will log an abstract for every successful _d_e_l_i_v_e_r_i_n_g _r_e_c_i_p_e it processes. LLLLOOOOGGGG Anything assigned to this variable will be appended to $LOGFILE. OOOORRRRGGGGMMMMAAAAIIIILLLL Usually the system mailbox (OOOORRRRiGGGGinal MMMMAAAAIIIILLLLbox). If, for some obscure reason (like `ffffiiiilllleeeessssyyyysssstttteeeemmmm ffffuuuullllllll') the mail could not be delivered, then this mailbox will be the last resort. If procmail fails to save the mail in here (deep, deep trouble :-), then the mail will bounce back to the sender. LLLLOOOOCCCCKKKKFFFFIIIILLLLEEEE Global semaphore file. If this file already exists, procmail will wait until it has gone before proceeding, and will create it itself (cleaning it up when ready, of course). If more than one _l_o_c_k_f_i_l_e are specified, then the previous one will be removed before trying to create the new one. The use of a global lockfile is discouraged, whenever possible use locallockfiles (on a per recipe basis) instead. LLLLOOOOCCCCKKKKEEEEXXXXTTTT Default extension that is appended to a destination file to determine what local _l_o_c_k_f_i_l_e to use (only if turned on, on a per- recipe basis). LLLLOOOOCCCCKKKKSSSSLLLLEEEEEEEEPPPP Number of seconds procmail will sleep before retrying on a _l_o_c_k_f_i_l_e (if it already existed); if not specified, it defaults to 8 seconds. LLLLOOOOCCCCKKKKTTTTIIIIMMMMEEEEOOOOUUUUTTTT Number of seconds that have to have passed since a _l_o_c_k_f_i_l_e was last modified/created before procmail decides that this must be an erroneously leftover lockfile that can be removed by force now. If zero, then no timeout will be used and procmail will wait forever until the lockfile is removed; if not specified, it defaults to 1024 seconds. This variable is useful to prevent indefinite hangups of sssseeeennnnddddmmmmaaaaiiiillll/procmail. Procmail is immune to clock skew across machines. Page 7 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) TTTTIIIIMMMMEEEEOOOOUUUUTTTT Number of seconds that have to have passed before procmail decides that some child it started must be hanging. The offending program will receive a TERMINATE signal from procmail, and processing of the rcfile will continue. If zero, then no timeout will be used and procmail will wait forever until the child has terminated; if not specified, it defaults to 960 seconds. MMMMSSSSGGGGPPPPRRRREEEEFFFFIIIIXXXX Filename prefix that is used when delivering to a directory (not used when delivering to an MH directory). HHHHOOOOSSSSTTTT If this is not the _h_o_s_t_n_a_m_e of the machine, processing of the current _r_c_f_i_l_e will immediately cease. If other rcfiles were specified on the command line, processing will continue with the next one. If all rcfiles are exhausted, the program will terminate, but will not generate an error (i.e. to the mailer it will seem that the mail has been delivered). UUUUMMMMAAAASSSSKKKK The name says it all (if it doesn't, then forget about this one :-). Anything assigned to UMASK is taken as an ooooccccttttaaaallll number. If not specified, the umask defaults to 077. If the umask permits o+x, all the mailboxes procmail delivers to directly will receive an o+x mode change. This can be used to check if new mail arrived. SSSSHHHHEEEELLLLLLLLMMMMEEEETTTTAAAASSSS If any of the characters in SHELLMETAS appears in the line specifying a filter or program, the line will be fed to $SHELL instead of being executed directly. SSSSHHHHEEEELLLLLLLLFFFFLLLLAAAAGGGGSSSS Any invocation of $SHELL will be like: "$SHELL" "$SHELLFLAGS" "$*"; SSSSEEEENNNNDDDDMMMMAAAAIIIILLLL If you're not using the _f_o_r_w_a_r_d_i_n_g facility don't worry about this one. It specifies the program being called to forward any mail. It gets invoked as: "$SENDMAIL" "$SENDMAILFLAGS" "$@"; Page 8 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) NNNNOOOORRRREEEESSSSRRRREEEETTTTRRRRYYYY Number of retries that are to be made if any `pppprrrroooocccceeeessssssss ttttaaaabbbblllleeee ffffuuuullllllll', `ffffiiiilllleeee ttttaaaabbbblllleeee ffffuuuullllllll', `oooouuuutttt ooooffff mmmmeeeemmmmoooorrrryyyy' or `oooouuuutttt ooooffff sssswwwwaaaapppp ssssppppaaaacccceeee' error should occur. If this number is negative, then procmail will retry indefinitely; if not specified, it defaults to 4 times. The retries occur with a $SUSPEND second interval. The idea behind this is, that if e.g. the _s_w_a_p _s_p_a_c_e has been exhausted or the _p_r_o_c_e_s_s _t_a_b_l_e is full, usually several other programs will either detect this as well and abort or crash 8-), thereby freeing valuable _r_e_s_o_u_r_c_e_s for procmail. SSSSUUUUSSSSPPPPEEEENNNNDDDD Number of seconds that procmail will pause if it has to wait for something that is currently unavailable (memory, fork, etc.); if not specified, it will default to 16 seconds. See also: LLLLOOOOCCCCKKKKSSSSLLLLEEEEEEEEPPPP. LLLLIIIINNNNEEEEBBBBUUUUFFFF Length of the internal line buffers, cannot be set smaller than 128. All lines read from the _r_c_f_i_l_e should not exceed $LINEBUF characters before and after expansion. If not specified, it defaults to 2048. This limit, of course, does _n_o_t apply to the mail itself, which can have arbitrary line lengths, or could be a binary file for that matter. DDDDEEEELLLLIIIIVVVVEEEERRRREEEEDDDD If set to `yes' procmail will pretend (to the mail agent) the mail has been delivered. If mail cannot be delivered after having met this assignment (set to `yes'), the mail will be lost (i.e. it will not bounce). TTTTRRRRAAAAPPPP When procmail terminates it will execute the contents of this variable. A copy of the mail can be read from stdin. Any output produced by this command will be appended to $LOGFILE. Possible uses for TRAP are: removal of temporary files, logging customised abstracts, etc. See also EEEEXXXXIIIITTTTCCCCOOOODDDDEEEE and LLLLOOOOGGGGAAAABBBBSSSSTTTTRRRRAAAACCCCTTTT. EEEEXXXXIIIITTTTCCCCOOOODDDDEEEE When procmail terminates and this variable has been set to a positive numeric value, procmail will use this as the exitcode. If this variable is set but empty, procmail will set the exitcode to whatever the TTTTRRRRAAAAPPPP program returns. If this variable has not been set, procmail will set it shortly before calling up the TTTTRRRRAAAAPPPP program. Page 9 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) LLLLAAAASSSSTTTTFFFFOOOOLLLLDDDDEEEERRRR This variable is assigned to by procmail whenever it is delivering to a folder or program. It always contains the name of the last folder (or program) procmail delivered to. MMMMAAAATTTTCCCCHHHH This variable is assigned to by procmail whenever it is told to extract text from a matching regular expression. It will contain all text matching the regular expression past the `\\\\////' token. SSSSHHHHIIIIFFFFTTTT Assigning a positive value to this variable has the same effect as the `shift' command in sssshhhh(1). This command is most useful to extract extra arguments passed to procmail when acting as a generic mailfilter. IIIINNNNCCCCLLLLUUUUDDDDEEEERRRRCCCC Names an rcfile (relative to the current directory) which will be included here as if it were part of the current rcfile. Unlimited nesting is permitted. CCCCOOOOMMMMSSSSAAAATTTT CCCCoooommmmssssaaaatttt(8)/bbbbiiiiffffffff(1) notification is on by default, it can be turned off by setting this variable to `no'. Alternatively the biff-service can be customised by setting it to either `service@', `@hostname', or `service@hostname'. When not specified it defaults to biff@localhost. DDDDRRRROOOOPPPPPPPPRRRRIIIIVVVVSSSS If set to `yes' procmail will drop all privileges it might have had (suid or sgid). This is only useful if you want to guarantee that the bottom half of the /usr/freeware/lib/procmail/procmailrc file is executed on behalf of the recipient. EEEExxxxtttteeeennnnddddeeeedddd rrrreeeegggguuuullllaaaarrrr eeeexxxxpppprrrreeeessssssssiiiioooonnnnssss The following tokens are known to both the procmail internal egrep and the standard eeeeggggrrrreeeepppp(1) (beware that some egrep implementations include other non-standard extensions): ^^^^ Start of a line. $$$$ End of a line. Page 10 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) .... Any character except a newline. aaaa**** Any sequence of zero or more a's. aaaa++++ Any sequence of one or more a's. aaaa???? Either zero or one a. [[[[^^^^----aaaa----dddd]]]] Any character which is nnnnooootttt either a dash, a, b, c, d or newline. ddddeeee||||aaaabbbbcccc Either the sequence `de' or `abc'. ((((aaaabbbbcccc))))**** Zero or more times the sequence `abc'. \\\\.... Matches a single dot; use \ to quote any of the magic characters to get rid of their special meaning. See also $\ variable substitution. These were only samples, of course, any more complex combination is valid as well. The following token meanings are special procmail extensions: ^^^^ or $$$$ Match a newline (for multiline matches). ^^^^^^^^ Anchor the expression at the very start of the search area, or if encountered at the end of the expression, anchor it at the very end of the search area. \\\\<<<< or \\\\>>>> Match the character before or after a word. They are merely a shorthand for `[^a-zA-Z0-9_]', but can also match newlines. Since they match actual characters, they are only suitable to delimit words, not to delimit inter-word space. \\\\//// Splits the expression in two parts. Everything matching the right part will be assigned to the MATCH environment variable. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS Look in the pppprrrrooooccccmmmmaaaaiiiilllleeeexxxx(5) man page. Page 11 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) CCCCAAAAVVVVEEEEAAAATTTTSSSS Continued lines in an action line that specifies a program always have to end in a backslash, even if the underlying shell would not need or want the backslash to indicate continuation. This is due to the two pass parsing process needed (first procmail, then the shell (or not, depending on SSSSHHHHEEEELLLLLLLLMMMMEEEETTTTAAAASSSS)). Don't put comments on the regular expression condition lines in a recipe, these lines are fed to the internal egrep _l_i_t_e_r_a_l_l_y (except for continuation backslashes at the end of a line). Leading whitespace on continued regular expression condition lines is usually ignored (so that they can be indented), but nnnnooootttt on continued condition lines that are evaluated according to the sssshhhh(1) substitution rules inside double quotes. Watch out for deadlocks when doing unhealthy things like forwarding mail to your own account. Deadlocks can be broken by proper use of LLLLOOOOCCCCKKKKTTTTIIIIMMMMEEEEOOOOUUUUTTTT. Any default values that procmail has for some environment variables will aaaallllwwwwaaaayyyyssss override the ones that were already defined. If you really want to override the defaults, you either have to put them in the rrrrccccffffiiiilllleeee or on the command line as arguments. Environment variables set iiiinnnnssssiiiiddddeeee the shell-interpreted-`|' action part of a recipe will nnnnooootttt retain their value after the recipe has finished since they are set in a subshell of procmail. To make sure the value of an environment variable is retained you have to put the assignment to the variable before the leading `|' of a recipe, so that it can capture stdout of the program. If you specify only a `h' or a `b' flag on a delivering recipe, and the recipe matches, then, unless the `c' flag is present as well, the body respectively the header of the mail will be silently lost. SSSSEEEEEEEE AAAALLLLSSSSOOOO pppprrrrooooccccmmmmaaaaiiiillll(1), pppprrrrooooccccmmmmaaaaiiiillllsssscccc(5), pppprrrrooooccccmmmmaaaaiiiilllleeeexxxx(5), sssshhhh(1), ccccsssshhhh(1), mmmmaaaaiiiillll(1), mmmmaaaaiiiillllxxxx(1), bbbbiiiinnnnmmmmaaaaiiiillll(1), uuuuuuuuccccpppp(1), aaaalllliiiiaaaasssseeeessss(5), sssseeeennnnddddmmmmaaaaiiiillll(8), eeeeggggrrrreeeepppp(1), rrrreeeeggggeeeexxxxpppp(5), ggggrrrreeeepppp(1), bbbbiiiiffffffff(1), ccccoooommmmssssaaaatttt(8), lllloooocccckkkkffffiiiilllleeee(1), ffffoooorrrrmmmmaaaaiiiillll(1) Page 12 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBUUUUGGGGSSSS The only substitutions of environment variables that can be handled by procmail itself are of the type $name, ${name}, ${name:-text}, ${name:+text}, ${name-text}, ${name+text}, $\name, $#, $n, $$, $?, $_, $- and $=; whereby $\name will be substituted by the all-magic-regular-expression- characters-disarmed equivalent of $name, $_ by the name of the current rcfile, $- by $LASTFOLDER and $= will contain the score of the last recipe. When the ----aaaa or ----mmmm options are used, "$@" will expand to respectively the specified argu- ment (list); but only when passed as in the argument list to a program. Procmail does not support the expansion of `~'. A line buffer of length $LINEBUF is used when processing the _r_c_f_i_l_e, any expansions hhhhaaaavvvveeee to fit within this limit; if they don't, behaviour is undefined. If the global lockfile has a _r_e_l_a_t_i_v_e path, and the current directory is not the same as when the global lockfile was created, then the global lockfile will not be removed if procmail exits at that point (remedy: use _a_b_s_o_l_u_t_e paths to specify global lockfiles). If an rcfile has a _r_e_l_a_t_i_v_e path and when the rcfile is first opened MMMMAAAAIIIILLLLDDDDIIIIRRRR contains a relative path, and if at one point procmail is instructed to clone itself and the current directory has changed since the rcfile was opened, then procmail will not be able to clone itself (remedy: use an _a_b_s_o_l_u_t_e path to reference the rcfile or make sure MAILDIR contains an absolute path as the rcfile is opened). A locallockfile on the recipe that marks the start of a non-forking nested block does not work as expected. When capturing stdout from a recipe into an environment variable, exactly one trailing newline will be stripped. MMMMIIIISSSSCCCCEEEELLLLLLLLAAAANNNNEEEEOOOOUUUUSSSS If the regular expression contains `^^^^TTTTOOOO____' it will be substi- tuted by `((((^^^^((((((((OOOOrrrriiiiggggiiiinnnnaaaallll----))))????((((RRRReeeesssseeeennnntttt----))))????((((TTTToooo||||CCCCcccc||||BBBBcccccccc))))||||((((XXXX----EEEEnnnnvvvveeeellllooooppppeeee ||||AAAAppppppppaaaarrrreeeennnnttttllllyyyy((((----RRRReeeesssseeeennnntttt))))????))))----TTTToooo))))::::((((....****[[[[^^^^----aaaa----zzzzAAAA----ZZZZ0000----9999____....]]]]))))????))))', which should catch all destination specifications containing a specific _a_d_d_r_e_s_s. If the regular expression contains `^^^^TTTTOOOO' it will be substi- tuted by `((((^^^^((((((((OOOOrrrriiiiggggiiiinnnnaaaallll----))))????((((RRRReeeesssseeeennnntttt----))))????((((TTTToooo||||CCCCcccc||||BBBBcccccccc))))||||((((XXXX----EEEEnnnnvvvveeeellllooooppppeeee ||||AAAAppppppppaaaarrrreeeennnnttttllllyyyy((((----RRRReeeesssseeeennnntttt))))????))))----TTTToooo))))::::((((....****[[[[^^^^aaaa----zzzzAAAA----ZZZZ]]]]))))????))))', which should catch all destination specifications containing a specific _w_o_r_d. Page 13 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) If the regular expression contains `^^^^FFFFRRRROOOOMMMM____DDDDAAAAEEEEMMMMOOOONNNN' it will be substituted by `((((^^^^((((PPPPrrrreeeecccceeeeddddeeeennnncccceeee::::....****((((jjjjuuuunnnnkkkk||||bbbbuuuullllkkkk||||lllliiiisssstttt))))||||TTTToooo:::: MMMMuuuullllttttiiiipppplllleeee rrrreeeecccciiiippppiiiieeeennnnttttssss ooooffff ||||((((((((((((RRRReeeesssseeeennnntttt----))))????((((FFFFrrrroooommmm||||SSSSeeeennnnddddeeeerrrr))))||||XXXX---- EEEEnnnnvvvveeeellllooooppppeeee----FFFFrrrroooommmm))))::::||||>>>>????FFFFrrrroooommmm ))))(((([[[[^^^^>>>>]]]]****[[[[^^^^((((....%%%%@@@@aaaa----zzzz0000---- 9999]]]]))))????((((PPPPoooosssstttt((((mmmmaaaa????((((sssstttt((((eeee????rrrr))))????||||nnnn))))||||ooooffffffffiiiicccceeee))))||||((((sssseeeennnndddd))))????MMMMaaaaiiiillll((((eeeerrrr))))????||||ddddaaaaeeeemmmmoooonnnn ||||mmmm((((mmmmddddffff||||aaaajjjjoooorrrrddddoooommmmoooo))))||||nnnn????uuuuuuuuccccpppp||||LLLLIIIISSSSTTTT((((SSSSEEEERRRRVVVV||||pppprrrroooocccc))))||||NNNNEEEETTTTSSSSEEEERRRRVVVV||||oooo((((wwwwnnnneeeerrrr||||ppppssss)))) wwwwhhhhiiiicccchhhh sssshhhhoooouuuulllldddd ccccaaaattttcccchhhh mmmmaaaaiiiillllssss ccccoooommmmiiiinnnngggg ffffrrrroooommmm mmmmoooosssstttt ddddaaaaeeeemmmmoooonnnnssss ((((hhhhoooowwww''''ssss tttthhhhaaaatttt ffffoooorrrr aaaa rrrreeeegggguuuullllaaaarrrr eeeexxxxpppprrrreeeessssssssiiiioooonnnn ::::----)))).... If the regular expression contains `^^^^FFFFRRRROOOOMMMM____MMMMAAAAIIIILLLLEEEERRRR' it will be substituted by `((((^^^^((((((((((((RRRReeeesssseeeennnntttt----))))????((((FFFFrrrroooommmm||||SSSSeeeennnnddddeeeerrrr))))||||XXXX----EEEEnnnnvvvveeeellllooooppppeeee----FFFFrrrroooommmm)))):::: ||||>>>>????FFFFrrrroooommmm ))))(((([[[[^^^^>>>>]]]]****[[[[^^^^((((....%%%%@@@@aaaa----zzzz0000----9999]]]]))))????((((PPPPoooosssstttt((((mmmmaaaa((((sssstttt((((eeeerrrr))))????||||nnnn))))||||ooooffffffffiiiicccceeee)))) ||||((((sssseeeennnndddd))))????MMMMaaaaiiiillll((((eeeerrrr))))????||||ddddaaaaeeeemmmmoooonnnn||||mmmmmmmmddddffff||||nnnn????uuuuuuuuccccpppp||||ooooppppssss||||rrrr((((eeeessssppppoooonnnnsssseeee||||ooooooootttt)))) ||||((((bbbbbbbbssss\\\\....))))????ssssmmmmttttpppp((((eeeerrrrrrrroooorrrr))))????||||ssss((((eeeerrrrvvvv((((iiiicccceeeessss????||||eeeerrrr))))||||yyyysssstttteeeemmmm)))) ||||AAAA((((ddddmmmmiiiinnnn((((iiiissssttttrrrraaaattttoooorrrr))))????||||MMMMMMMMGGGGRRRR))))))))(((((((([[[[^^^^))))....!!!!::::aaaa----zzzz0000----9999]]]][[[[----____aaaa----zzzz0000----9999]]]]****))))????[[[[%%%%@@@@>>>>\\\\tttt ]]]][[[[^^^^<<<< ))))]]]]****((((\\\\((((....****\\\\))))....****))))????))))????$$$$(((([[[[^^^^>>>>]]]]||||$$$$))))))))' (a stripped down version of `^^^^FFFFRRRROOOOMMMM____DDDDAAAAEEEEMMMMOOOONNNN'), which should catch mails coming from most mailer-daemons. When assigning boolean values to variables like VERBOSE, DELIVERED or COMSAT, procmail accepts as true every string starting with: a non-zero value, `on', `y', `t' or `e'. False is every string starting with: a zero value, `off', `n', `f' or `d'. If the action line of a recipe specifies a program, a sole backslash-newline pair in it on an otherwise empty line will be converted into a newline. The regular expression engine built into procmail does not support named character classes. NNNNOOOOTTTTEEEESSSS Since unquoted leading whitespace is generally ignored in the rcfile you can indent everything to taste. The leading `|' on the action line to specify a program or filter is stripped before checking for $SHELLMETAS. Files included with the INCLUDERC directive containing only environment variable assignments can be shared with sh. For _r_e_a_l_l_y complicated processing you can even consider cal- ling pppprrrrooooccccmmmmaaaaiiiillll recursively. In the old days, the `:0' that marks the beginning of a re- cipe, had to be changed to `:n', whereby `n' denotes the number of conditions that follow. Page 14 (printed 8/25/98) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) BBBBuuuuGGGGlllleeeessssssss ((((1111999999997777////00004444////11111111)))) PPPPRRRROOOOCCCCMMMMAAAAIIIILLLLRRRRCCCC((((5555)))) AAAAUUUUTTTTHHHHOOOORRRR Stephen R. van den Berg <srb@cuci.nl> Page 15 (printed 8/25/98) 
